home *** CD-ROM | disk | FTP | other *** search
/ Network Support Library / RoseWare - Network Support Library.iso / btrieve / btr61m.exe / 11CH5C.TXT < prev    next >
Text File  |  1993-07-16  |  28KB  |  848 lines
  1. CHAPTER 5    USING BTRIEVE UTILITIES (continued)
  2.  
  3. SINDEX
  4.  
  5. The SINDEX command creates an additional index for an
  6. existing Btrieve file.  The key number of the new
  7. index is one higher than the previous highest key
  8. number for the Btrieve file.  An exception is if a
  9. DROP command previously removed an index without
  10. renumbering the remaining keys, thus producing an
  11. unused key number; in this case, the new index
  12. receives the first unused number.
  13.  
  14. Before you can use the SINDEX command, you must create
  15. a description file to define key specifications for
  16. the index.  For more information on description files,
  17. see Appendix A.
  18.  
  19. Format
  20.  
  21.   LOAD BUTIL -SINDEX btrvFile descriptionFile
  22.      [/Oowner]
  23.  
  24.   btrvFile      The full pathname of the Btrieve file
  25.           for which you are creating the index.
  26.  
  27.   descriptionFile The full pathname of the description
  28.           file containing the description of the
  29.           index you want to create.
  30.  
  31.   owner       The owner name for the Btrieve file, if
  32.           required.
  33.  
  34. Examples
  35.  
  36. The following example adds an index to the
  37. PATIENTS.DTA file.  The name of the description file
  38. is SUPPIDX.DES.
  39.  
  40.    LOAD BUTIL -SINDEX
  41.       sys:\nwsql\demodata\patients.dta
  42.       sys:\nwsql\suppidx.des
  43.  
  44.  
  45. STARTBU
  46.  
  47. The STARTBU command places a file or set of files into
  48. continuous operation for backup purposes.
  49.  
  50. To back up files using continuous operation, first
  51. issue the LOAD BUTIL -STARTBU command, followed by the
  52. Btrieve file or set of Btrieve files.  Next, run your
  53. backup program.  Then, issue the LOAD BUTIL -ENDBU
  54. command to stop continuous operation.  For more
  55. information on the ENDBU command, see "ENDBU." For
  56. more information on continuous operation, see
  57. "Continuous Operation."
  58.  
  59. SUGGESTION:  When you place a Btrieve file into
  60. continuous operation mode, Btrieve creates a temporary
  61. file with the same name as the data file, but with a
  62. .^^^ extension.  Therefore, do not create multiple
  63. Btrieve files with the same names but different
  64. extensions.  For example, do not use a naming scheme
  65. such as INVOICE.HDR and INVOICE.DET for your Btrieve
  66. files.
  67.  
  68. Format
  69.  
  70.   LOAD BUTIL -STARTBU <btrvFile | @filename>
  71.  
  72.   btrvFile  The full pathname of the Btrieve file on
  73.         which to begin continuous operation for
  74.         backup.
  75.  
  76.   @filename The name of a text file containing the full
  77.         pathnames of files on which to begin
  78.         continuous operation.  Separate these
  79.         pathnames with a space or a carriage
  80.         return/line feed.
  81.  
  82. This command begins continuous operation only on the
  83. files you specify.  You cannot use wildcards with the
  84. STARTBU command.
  85.  
  86. Example
  87.  
  88. The following example starts continuous operation on
  89. the PATIENTS.DTA file.
  90.  
  91.    LOAD BUTIL -STARTBU
  92.       sys:\nwsql\demodata\patients.dta
  93.  
  94.  
  95. STAT
  96.  
  97. The STAT command reports the defined characteristics
  98. of a Btrieve file and statistics about the file's
  99. contents.
  100.  
  101. Format
  102.  
  103.   LOAD BUTIL -STAT btrvFile [/Oowner]
  104.  
  105.   btrvFile The full pathname of the Btrieve file for
  106.        which you want to display statistics.
  107.  
  108.   owner    The owner name for the Btrieve file, if
  109.        required.
  110.  
  111. Example
  112.  
  113. The following example retrieves the file statistics
  114. for the PATIENTS.DTA file.  The Btrieve file does not
  115. have an owner name.
  116.  
  117.    LOAD BUTIL -STAT
  118.       sys:\system\515\patients.dta
  119.  
  120. The following illustration shows the resulting output
  121. screen:
  122.  
  123. This example shows that the file called PATIENTS.DTA
  124. was defined with a record length of 104 bytes, does
  125. not allow variable-length records, has 3 keys, and has
  126. a page size of 2,048 bytes.  Sixteen records have been
  127. inserted into the file.  The file does not use data
  128. compression and is using all its preallocated pages.
  129.  
  130. The Btrieve file version is 6.0.  (If you created the
  131. Btrieve file with VATs or multiple alternate collating
  132. sequences, the STAT command displays file version
  133. 6.1.  Otherwise, it displays file version 6.0.)
  134.  
  135. NOTE:  The STAT command designates case-insensitive
  136. keys and key segments with the letter I, descending
  137. keys with the symbol <, manual keys with the letter M,
  138. alternate collating sequence keys with an asterisk
  139. (*), and repeating-duplicatable keys with the letter
  140. R.  Indexes created with SINDEX are also designated
  141. with the letter R by default unless you specified the
  142. Reserved Duplicate Pointer element.
  143.  
  144. The remainder of the screen provides information about
  145. specific keys.  For example, the screen shows that Key
  146. 0 allows duplicates, is modifiable, and consists of
  147. two segments:
  148.  
  149. o The first segment starts in position 21, is 20
  150.   characters long, allows duplicates, is modifiable,
  151.   and will be sorted as a string type.  The dashes
  152.   indicate that a null value was not defined.  The
  153.   Total column indicates that 16 unique key values were
  154.   inserted for this key.
  155.  
  156. o The second segment starts in position 7, is 12
  157.   characters long, allows duplicates, is modifiable,
  158.   and will be sorted as a string type.  Sixteen unique
  159.   key values were inserted for this key.
  160.  
  161. Key 1 consists of one segment.  It starts in position
  162. 1, is 6 characters long, does not allow duplicates, is
  163. modifiable, and will be sorted as a string type.
  164. Sixteen unique key values were inserted for this key.
  165.  
  166. Key 2 consists of one segment.  It starts in position
  167. 83, is 10 characters long, allows duplicates, is
  168. modifiable, and will be sorted as a string type.
  169. Seven unique key values were inserted for this key.
  170.  
  171. NOTE:  The STAT command handles indexes the same
  172. whether they were created by the Btrieve Create
  173. Supplemental Index operation (in Btrieve v6.x) or the
  174. Btrieve Create operation.  The information displayed
  175. by the STAT command does not differentiate between
  176. these indexes.
  177.  
  178.  
  179. VER
  180.  
  181. The VER command returns the version number of the Btrieve NLM
  182. loaded at the server.
  183.  
  184. Format
  185.  
  186.   LOAD BUTIL -VER
  187.  
  188. Remarks
  189.  
  190. When you run the VER command, the utility displays
  191. messages similar to the following:
  192.  
  193.    Btrieve Version is 6.1 NLM.
  194.    Operation completed successfully.
  195.  
  196.  
  197. Roll Forward Utility
  198.  
  199. The Roll Forward utility is a workstation utility that
  200. recovers changes made to a Btrieve file between the
  201. time of the last backup and a system failure.  The
  202. changes are stored in a log file.  If a system failure
  203. occurs, you can restore the backup copy of your Btrieve
  204. file and run the Roll Forward utility.  The utility
  205. applies the changes stored in the log file to your
  206. backup copy.
  207.  
  208. Roll Forward utilities are available for DOS, OS/2,
  209. and Windows operating environments, as follows:
  210.  
  211. o BROLLFWD.EXE - The Roll Forward utility for the DOS
  212.   operating environment.  You run BROLLFWD from the
  213.   command line.
  214.  
  215. o PBROLL.EXE - The Roll Forward utility for the OS/2
  216.   environment.  You run PBROLL interactively.
  217.  
  218. o WBROLL.EXE - The Roll Forward utility for the Windows
  219.   environment.  You run WBROLL interactively.
  220.  
  221. NOTE:  The procedure for running PBROLL and WBROLL is
  222. the same.
  223.  
  224.  
  225. Setting Up Files for Logging
  226.  
  227. To take advantage of Btrieve╒s logging feature and the
  228. Roll Forward utility, you must first set up your
  229. Btrieve files for logging, as follows:
  230.  
  231. 1.  Activate Btrieve╒s logging configuration option
  232. (using the Setup utility, BSETUP.NLM).
  233.  
  234. 2.  Create the log configuration file, BLOG.CFG.
  235.  
  236. 3.  Back up your data files before the logging
  237. begins.  The following sections explain each step.
  238.  
  239.  
  240. Activating the Btrieve Logging Option
  241.  
  242. You can activate Btrieve╒s logging feature by
  243. specifying Yes for the Logging of Selected Files
  244. configuration option in the Setup utility.  The
  245. default setting for this option is No.  If you did not
  246. specify Yes for this option when you configured
  247. Btrieve, complete the following steps to activate
  248. Btrieve logging:
  249.  
  250. 1.  Run the Setup utility (BSETUP.NLM).
  251.  
  252. 2.  When the Available Options menu appears, select
  253. Set Btrieve Configuration.
  254.  
  255. 3.  When the Current Btrieve Configuration screen
  256. appears, specify Yes for the Logging of Selected Files
  257. option.
  258.  
  259. 4.  Press the Escape key.
  260.  
  261. 5.  When the Save Configuration Changes?  window
  262. appears, select Yes.
  263.  
  264. 6.  To have your changes take effect, unload Btrieve
  265. using the BSTOP command and then reload it using the
  266. BSTART command.  Btrieve reloads with the logging
  267. feature activated.
  268.  
  269.  
  270. Creating the Log Configuration File
  271.  
  272. BLOG.CFG is the log configuration file.  It specifies
  273. all Btrieve files for which you want to log changes on
  274. a given volume.
  275.  
  276. You should create a BLOG directory at the root of each
  277. volume that contains Btrieve files for which you want
  278. to log changes.  You can then create a BLOG.CFG file
  279. in each BLOG directory and place entries in it, as
  280. follows:
  281.  
  282. 1.  Create the BLOG.CFG file.
  283.  
  284. 2.  Open the BLOG.CFG file.
  285.  
  286. 3.  For each Btrieve file for which you want to log
  287. operations, create an entry using the following format:
  288.  
  289.   \directory1\btrvFile[=\directory2\logFile]
  290.  
  291.   directory1 The path to the Btrieve file to be logged.
  292.          Do not include server names, volume names,
  293.          or DOS drive letters.
  294.  
  295.   btrvFile   The name of the Btrieve file to be logged.
  296.  
  297.   directory2 The path to the log file.    If the log file
  298.          and the Btrieve file are on the same volume,
  299.          you can omit the server and volume names.
  300.          If they are on different volumes, you must
  301.          include the server and volume names.
  302.  
  303.          NOTE:  When including the server name, place
  304.          a double backslash (\\) before it.
  305.  
  306.   logFile    The name of the log file.    Although the log
  307.          file and the Btrieve file can be on
  308.          different volumes, they cannot be on
  309.          different servers.
  310.  
  311. Make sure each entry fits completely on one line.  You
  312. can place multiple entries on the same line, but they
  313. must be separated by at least one space.  Each line
  314. can contain a maximum of 256 characters.
  315.  
  316. If you do not provide a log name, Btrieve (at the time
  317. the file is first opened) assigns the original
  318. filename to the log file and gives it a .LOG
  319. extension.  For example, if you did not specify a log
  320. name for the Btrieve file TEST01.DAT in the directory
  321. TEST, Btrieve would assign the full name
  322. \TEST\TEST01.LOG to the associated log file.  In this
  323. case, the default log file shares the same directory
  324. as the Btrieve file.
  325.  
  326. The next three examples show sample entries in the file
  327. \BLOG\BLOG.CFG on the SYS:  volume of the CORP
  328. server.  Each of these entries produces the same
  329. result:  activity in the file \DATA\B.BTR on the CORP
  330. server's SYS:  volume is logged into the file
  331. \DATA\B.LOG on the CORP server's SYS:  volume.
  332.  
  333.    \data\b.btr
  334.    \data\b.btr=\data\b.log
  335.    \data\b.btr=\\corp\sys:\data\b.log
  336.  
  337. The next example (again, a sample entry in
  338. \BLOG\BLOG.CFG on the CORP server's SYS:  volume)
  339. shows how to log activity to a volume other than the
  340. Btrieve data file╒s volume.  This entry directs
  341. Btrieve to log activity in the file \DATA\B.BTR on the
  342. CORP server's SYS:  volume into the log file
  343. \DATA\B.LOG on the VOL1:  volume of the CORP server.
  344.  
  345.    \data\b.btr=\\corp\vol1:\data\b.log
  346.  
  347.  
  348. Backing Up Data Files
  349.  
  350. Be sure to make a backup copy of your Btrieve data
  351. files before logging begins.  When logging is
  352. activated for a given file, Btrieve records (in the
  353. corresponding log file) all the operations that change
  354. that file.  Btrieve continues appending subsequent
  355. operations to the end of this log file until the log
  356. file is deleted.  Consequently, it is important to
  357. perform periodic maintenance to reduce the size of the
  358. log files.
  359.  
  360. IMPORTANT:  Every time you back up your Btrieve data
  361. files, delete the associated log files before
  362. executing any further operations that could change the
  363. files.  Synchronization of the backup data files and
  364. the associated log files is critical to recovering
  365. operations successfully.
  366.  
  367.  
  368. Running the Roll Forward Utility in a DOS Environment
  369.  
  370. To run the Roll Forward utility in a DOS environment,
  371. enter the BROLLFWD command using the following format:
  372.  
  373.    BROLLFWD <btrvFile | @listFile | /A>
  374.      [/D:nn] [/T:nn] [/K:nn] [/H] [/V] [/L]
  375.      [/O:ownerName]
  376.  
  377. The following list describes the BROLLFWD command syntax:
  378.  
  379.    btrvFile  Specifies the name of a single Btrieve file
  380.          to be recovered.
  381.  
  382.    @listFile Specifies the name of a text file that
  383.          contains a list of Btrieve filenames
  384.          separated by one or more spaces.  Use a list
  385.          file to recover multiple files.
  386.  
  387.    /A         Specifies that you want to recover all the
  388.          Btrieve files in the BLOG.GFG file.
  389.  
  390.    /D:         Specifies the data buffer size (in kilobytes)
  391.          that the Roll Forward utility allocates for
  392.          Btrieve log operations.  /D:  is optional.
  393.          The default size is 8 KB, the minimum is 1
  394.          KB, and the maximum is 64 KB.
  395.          You can specify the length in increments of 1
  396.          KB.
  397.  
  398.    /T:         Specifies the length of the data (in bytes)
  399.          that will be printed in the list file for
  400.          each operation that is rolled forward.  /T:
  401.          is optional.  Valid data lengths range from 1
  402.          through the value of the data
  403.          buffer size specified with the /D:  option.
  404.          The default value is 40 bytes.
  405.  
  406.    /K:         Specifies the length of the key (in bytes)
  407.          that will be printed in the list file for
  408.          each operation that is rolled forward.  /K:
  409.          is optional.  Valid lengths for printing keys
  410.          range from 1 through 255 bytes.  The default
  411.          value is 10 bytes.
  412.  
  413.    /H         Specifies that the Btrieve operations in the
  414.          list file will be printed in hexadecimal
  415.          format.  The default prints the data and key
  416.          in decimal numbers. /H is optional.
  417.  
  418.    /V         Specifies that for each logged file in the
  419.          list file, the utility will add the time
  420.          stamps of the Roll Forward operation and log
  421.          file creation.  For each logged operation, it
  422.          adds the name of the user who performed the
  423.          operation, the internetwork address of the
  424.          source workstation, the time stamp indicating
  425.          when the operation was performed, and the
  426.          record length and key number used in the
  427.          operation.  /V is optional.
  428.  
  429.    /L         Specifies that you want only to list the
  430.          logged operations.  The logged operations
  431.          will not be executed.  The operations will be
  432.          listed to the standard output device.  /L is
  433.          optional.
  434.  
  435.    /O:         Specifies an owner name.  If the backup copy
  436.          of the Btrieve file you want to recover has a
  437.          Btrieve owner name, you must provide this
  438.          option.  This protects the owned files from
  439.          being changed inadvertently.  Typically,
  440.          all owned files in an application have the
  441.          same owner name.  Therefore,
  442.          the utility assumes that all Btrieve files
  443.          listed in the file list have the same owner
  444.          name.
  445.  
  446.          However, some Btrieve files in a file list
  447.          may have different owners.  If a Btrieve
  448.          file has an owner name, that
  449.          file has only one owner name.  In that case,
  450.          the utility prompts you to enter the owner
  451.          name.  Similarly, if you do not specify /O
  452.          and the utility encounters a Btrieve file
  453.          that requires an owner name,
  454.          BROLLFWD prompts you for that owner name.
  455.  
  456.    ownerName Specifies the owner name of the Btrieve
  457.          files to be accessed.  When you use /O, you
  458.          must specify an owner name.
  459.  
  460.  
  461. Running the Roll Forward Utility in an OS/2 or Windows Environment
  462.  
  463. The following list shows a few ways you can run the
  464. Roll Forward utility:
  465.  
  466.    From This Position           Do This
  467.  
  468.    OS/2 command line           Type PBROLL
  469.    Presentation Manager        Double click on the Roll Forward icon
  470.    Windows               Double click on the Roll Forward icon,
  471.                    or choose Run... from the
  472.                    File pulldown menu and type
  473.                    WBROLL
  474.  
  475. NOTE:  The following documentation applies to both OS/2
  476. and Windows operating environments, but the screen
  477. examples show Windows screens only.
  478.  
  479. To use the Roll Forward utility in the OS/2 and Windows
  480. environments, you need to complete the following steps:
  481.  
  482. 1.  Set the Roll Forward utility╒s program options.
  483.  
  484. 2.  Place in the utility╒s queue all the items you
  485. intend to roll forward.
  486.  
  487. 3.  Start rolling forward the items in the queue.
  488. Following a brief description of the Roll Forward
  489. utility's pulldown menus, subsequent sections describe
  490. each of these steps in detail.
  491.  
  492.  
  493. Using the Roll Forward Pulldown Menus
  494.  
  495. After starting the Roll Forward utility, you can
  496. access two pulldown menus:  Queue and Options.
  497.  
  498. SUGGESTION:  If you are not using a mouse, you can
  499. access the menus by pressing and holding the Alt key
  500. while typing the letter highlighted in the menu
  501. selection.  For example, to select the Queue pulldown
  502. menu, hold down the Alt key and press Q.  To move
  503. between fields in the dialog boxes, use the Tab key.
  504.  
  505. Queue Menu
  506.  
  507. When you select Queue from the main menu, a pulldown
  508. menu offers the following:
  509.  
  510.    Add...
  511.    Generates a dialog box in which you can specify items
  512.    to be placed in the queue.
  513.  
  514.    View...
  515.    Generates a dialog box in which you can view the
  516.    queued items.  If no items are in the queue, this
  517.    selection is disabled.
  518.  
  519.    Start
  520.    Begins the process of rolling forward all items
  521.    in the queue.  Like the View...  selection, this
  522.    selection is disabled if no items are in the queue.
  523.  
  524.    Exit
  525.    Exits the utility.  In the Windows and OS/2
  526.    environments, you can also press F3 to exit.
  527.  
  528. Options Menu
  529.  
  530. When you select Options from the main menu, a pulldown
  531. menu offers the following:
  532.  
  533.    Options...
  534.    Generates a dialog box that lets you set the data
  535.    buffer length and the list options.
  536.  
  537.    About...
  538.    Displays the version of the Roll Forward utility that
  539.    you are running.
  540.  
  541.  
  542. Setting Options for the Roll Forward Utility
  543.  
  544. You should set program options for the Roll Forward
  545. utility before using the utility to roll forward
  546. changes.  These options control the following:
  547.  
  548. o Size of the data buffer used to retrieve records
  549. o Multitasking operation
  550. o Contents of the list file (BROLL.LST)
  551.  
  552. Table 5-5 describes each of these options in detail.
  553. Subsequent sections describe the two methods you can
  554. use to set the program options:
  555.  
  556. o By using the Options pulldown menu.
  557. o By editing the initialization file.  (The NOVDB.INI
  558.   file for OS/2 cannot be edited.)
  559.  
  560. Table 5-5
  561. Roll Forward
  562. Program Options
  563.  
  564. Program Option         Description
  565.  
  566. Data Length            Specifies the number of
  567.                        kilobytes allocated for the data
  568.                        buffer that the utility uses to
  569.                        process the logged entries.
  570.                        This number should be at least
  571.                        as large as the largest
  572.                        record to be rolled forward.
  573.                        The default is 4 KB.
  574.  
  575. Exclusive Operation    Runs in one of two ways, depending on your
  576.                        operating system:
  577.  
  578.             Windows    Windows v3.x emulates multitasking and
  579.                        lets you run more than one
  580.                        application concurrently. If
  581.                        you select Exclusive Operation,
  582.                        the Roll Forward utility uses
  583.                        the CPU time exclusively. If you
  584.                        do not select this option, the
  585.                        utility shares CPU time with
  586.                        other applications.
  587.  
  588.                        If you plan to run recorder-type
  589.                        programs or batch execution
  590.                        programs with Roll Forward,
  591.                        check this box to ensure correct
  592.                        operation. Selecting Exclusive
  593.                        operation also enhances
  594.                        performance slightly.
  595.  
  596.                OS/2    OS/2 provides true multitasking;
  597.                        the Roll Forward utility can
  598.                        always run concurrently with
  599.                        other applications.
  600.                        You can, however, vary the
  601.                        priority of the Roll Forward
  602.                        thread to accommodate other
  603.                        threads that are running. The
  604.                        following priorities are
  605.                        available:
  606.  
  607.                        Idle - Runs only when no other
  608.                          tasks are waiting for the CPU
  609.                        Low - Lower priority than normal
  610.                        Normal - The default thread
  611.                          priority
  612.                        High - Higher priority than
  613.                          normal
  614.  
  615. List Files             Specifies the listing options
  616.                        for the list file BROLL.LST.
  617.                        You can select one of the
  618.                        following:
  619.  
  620.             Verbose    For each logged file, this
  621.                        option adds the time stamps of
  622.                        the Roll Forward operation and
  623.                        log file creation to the list
  624.                        file. For each logged operation,
  625.                        it adds the name of the user who
  626.                        performed the operation, the
  627.                        internetwork address of the
  628.                        source workstation, the time
  629.                        stamp indicating when the
  630.                        operation was performed, and the
  631.                        user-defined lengths of data and
  632.                        key numbers used in the
  633.                        operation.
  634.  
  635.        Data to list    Specifies the length of the data
  636.                        buffer that will be printed in
  637.                        the list file for each operation
  638.                        that is rolled forward.
  639.  
  640.         Key to list    Specifies the length of the key
  641.                        buffer that will be printed in
  642.                        the list file for each operation
  643.                        that is rolled forward.
  644.  
  645.               ASCII    Lists the Btrieve operation
  646.                        values in ASCII mode.
  647.  
  648.                 Hex    Lists the Btrieve operation values in
  649.                        hexadecimal mode.
  650.  
  651.  
  652. Setting Options from the Options Menu
  653.  
  654. To set Roll Forward options using the Options pulldown
  655. menu, complete the following steps:
  656.  
  657. 1.  Select Options from the Roll Forward main menu.
  658.  
  659. 2.  Select Options...  from the Options pulldown menu
  660. to display the following dialog box:
  661.  
  662. 3.  Set the options using the guidelines provided in
  663. Table 5-5.
  664.  
  665. 4.  After setting the options, select one of the
  666. following:
  667.  
  668. o Save - accepts and saves the changes you have made
  669.   to the .INI file.
  670.  
  671. o OK - accepts the changes but does not save them to
  672.   the .INI file.
  673.  
  674. o CANCEL - cancels the changes and returns to the
  675.   previous screen.
  676.  
  677.  
  678. Setting Options in the Initialization File
  679.  
  680. You can also change the setting of the Roll Forward
  681. utility╒s program options by editing the
  682. initialization file NOVDB.INI (for Windows).  These
  683. settings are specified under [wbroll] in NOVDB.INI.
  684. An example specification for [wbroll] follows:
  685.  
  686.    [wbroll]
  687.    datalength=4
  688.    exclusive=no
  689.    outputmode=ASCII
  690.    listverbose=yes
  691.    datalist=32
  692.    keylist=16
  693.  
  694.  
  695. Placing Items in the Queue
  696.  
  697. The Roll Forward utility works on a queued-job basis.
  698. When you specify the Btrieve files that are to be
  699. rolled forward, the utility places them in the queue.
  700.  
  701. This section discusses the Roll Forward utility╒s
  702. queue and explains how to do the following:
  703.  
  704. o Add items to the queue
  705. o Delete items from the queue
  706. o Change list options for a queued item
  707. o View items in the queue
  708.  
  709.  
  710. Adding Items to the Queue
  711.  
  712. The queue can hold a maximum of 32 items.  Any of the
  713. following represents one item:
  714.  
  715. o An individual Btrieve file
  716. o A text file listing several Btrieve files
  717. o All files from a specified volume
  718.  
  719. To add items to the queue, complete the following steps:
  720.  
  721. 1.  Select Add...  from the Queue pulldown menu.  The
  722. Add...  dialog box (similar to the following) appears:
  723.  
  724. 2.  Select the Btrieve file or files to be rolled
  725. forward, as follows:
  726.  
  727. o To select the entire volume, click on the Entire
  728.   Volume check box.
  729.  
  730. o To select a particular file, scroll the Directories
  731.   list box (the list box on the right) to find your
  732.   directory or drive.  Double click on the directory
  733.   name and then choose the filename from the Files list
  734.   box (the list box on the left).
  735.  
  736. o To enter a text file containing a list of files,
  737.   enter the filename in the Filename text box.  To
  738.   select all available files with a certain extension,
  739.   you can enter a wildcard character for the filename,
  740.   followed by the extension.  Then, press Enter.
  741.  
  742. NOTE:  To select the parent directory from the
  743. Directories list box, set "show dots=on" in your
  744. NET.CFG file.  Refer to your NetWare documentation for
  745. more information on NET.CFG.
  746.  
  747. 3.  Specify the list option for the queue item you are
  748. adding, as follows:
  749.  
  750. o If you want only to list the Btrieve operations to be
  751.   rolled forward (without actually rolling the logged
  752.   operations forward), click on the List Only and List
  753.   File check boxes.  The operations will be listed in
  754.   the file BROLL.LST in the BLOG directory.
  755.  
  756. o If you want to list the operations in BROLL.LST and
  757.   roll forward the operations, click on the List File
  758.   check box.
  759.  
  760. o If you do not want to list the operations that are
  761.   rolled forward but you do want to roll the operations
  762.   forward, do not click on either the List Only or List
  763.   File checkbox.
  764.  
  765. 4.  If the Btrieve file has an owner name, specify the
  766. owner name in the Owner text box.
  767.  
  768. 5.  Click on the Add button to add the item to the
  769. queue.
  770.  
  771. 6.  Repeat Steps 2 through 5 to add each additional
  772. item to the queue.
  773.  
  774. 7.  To review the items you have placed in the queue,
  775. click on the Queue...  button.  The items selected
  776. appear on a screen similar to the following:
  777.  
  778. 8.  When you are finished, click on the OK button.
  779.  
  780. NOTE:  At any time, you can click on the CANCEL button
  781. to cancel your changes and return to the previous
  782. screen.
  783.  
  784.  
  785. Deleting Items from the Queue
  786.  
  787. If you need to delete an item from the queue, complete the
  788. following steps:
  789.  
  790. 1.  Select View...  from the Queue pulldown menu.
  791.  
  792. 2.  Select the item you want to delete.
  793.  
  794. 3.  Click on the Delete button to remove the item from
  795. the queue.
  796.  
  797. 4.  Click on the OK button.
  798.  
  799. NOTE:  If you change your mind and want to cancel your
  800. deletion, click on the CANCEL button instead of OK.
  801.  
  802.  
  803. Changing List Options for a Queued Item
  804.  
  805. You can use either of the following methods to change
  806. the list options (that is, your choices regarding the
  807. List Only and List File check boxes) for a given queue
  808. item:
  809.  
  810. o Select Add...  from the Queue menu and then click on
  811.   the Add button.  Next, select the relevant item and
  812.   choose the list option you prefer.
  813.  
  814. o Select View...  from the Queue menu, select the
  815.   relevant item, and choose the list option you prefer.
  816.  
  817.  
  818. Viewing Items in the Queue
  819.  
  820. You can use either of the following methods to view items in the
  821. queue:
  822.  
  823. o From the Queue pulldown menu, select View...    to
  824.   display a dialog box that lists the queued items.
  825.   (You can select this option only if the queue has one
  826.   or more items in it.)
  827.  
  828. o While you are adding items to the queue, click on the
  829.   Queue...  button to list the files in the queue.
  830.  
  831.  
  832. Rolling Forward Items in the Queue
  833.  
  834. Once the queue contains all the items for which you want to roll
  835. forward changes, you are ready to start the roll forward process.
  836. Select Start from the Queue pulldown menu.
  837.  
  838. NOTE:  The Roll Forward utility allows a maximum of 250
  839. concurrent transactions per Btrieve file during the
  840. roll forward process.
  841.  
  842. After you select Start, the utility lists each Btrieve
  843. file being rolled forward and specifies the number of
  844. logged entries for each file.  (The number of logged
  845. entries is shown to the left of the filename.)
  846.  
  847.  
  848.